From: Joey Hess Date: Mon, 10 Mar 2025 18:15:07 +0000 (-0400) Subject: document output files must be regular files X-Git-Tag: archive/raspbian/10.20250416-2+rpi1~1^2~6^2~99 X-Git-Url: https://dgit.raspbian.org/%22http:/www.example.com/cgi/%22https:/www.github.com/%22bookmarks:///%22http:/www.example.com/cgi/%22https:/www.github.com/%22bookmarks:/?a=commitdiff_plain;h=7bda5f470c54d29b4d49b48ea5a15d025761efa6;p=git-annex.git document output files must be regular files --- diff --git a/doc/design/compute_special_remote_interface.mdwn b/doc/design/compute_special_remote_interface.mdwn index e6fad0f2b1..0ab7c45df4 100644 --- a/doc/design/compute_special_remote_interface.mdwn +++ b/doc/design/compute_special_remote_interface.mdwn @@ -65,8 +65,11 @@ dashed options. If there is a path traversal attack, the program's stdin will be closed without a path being written to it. The filename of the output file is both the filename in the program's -temporary directory, and also the filename that will be added to the -git-annex repository by `git-annex compute`. +temporary directory that it should write to, and also the filename that will +be added to the git-annex repository by `git-annex compute`. + +The program must write a regular file to the output file. Symlinks +or other special files will not be accepted as output files. If git-annex sees that an output file is growing, it will use its file size when displaying progress to the user. So if possible, the program should